Autogenerated HTML docs for v2.3.0-130-g3188a
diff --git a/githooks.html b/githooks.html index d6ef1e3..d3de352 100644 --- a/githooks.html +++ b/githooks.html
@@ -1045,6 +1045,32 @@ for the user.</p></div> </div> <div class="sect2"> +<h3 id="_push_to_checkout">push-to-checkout</h3> +<div class="paragraph"><p>This hook is invoked by <em>git-receive-pack</em> on the remote repository, +which happens when a <em>git push</em> is done on a local repository, when +the push tries to update the branch that is currently checked out +and the <code>receive.denyCurrentBranch</code> configuration variable is set to +<code>updateInstead</code>. Such a push by default is refused if the working +tree and the index of the remote repository has any difference from +the currently checked out commit; when both the working tree and the +index match the current commit, they are updated to match the newly +pushed tip of the branch. This hook is to be used to override the +default behaviour.</p></div> +<div class="paragraph"><p>The hook receives the commit with which the tip of the current +branch is going to be updated. It can exit with a non-zero status +to refuse the push (when it does so, it must not modify the index or +the working tree). Or it can make any necessary changes to the +working tree and to the index to bring them to the desired state +when the tip of the current branch is updated to the new commit, and +exit with a zero status.</p></div> +<div class="paragraph"><p>For example, the hook can simply run <code>git read-tree -u -m HEAD "$1"</code> +in order to emulate <em>git fetch</em> that is run in the reverse direction +with <code>git push</code>, as the two-tree form of <code>read-tree -u -m</code> is +essentially the same as <code>git checkout</code> that switches branches while +keeping the local changes in the working tree that do not interfere +with the difference between the branches.</p></div> +</div> +<div class="sect2"> <h3 id="_pre_auto_gc">pre-auto-gc</h3> <div class="paragraph"><p>This hook is invoked by <em>git gc --auto</em>. It takes no parameter, and exiting with non-zero status from this script causes the <em>git gc --auto</em> @@ -1098,7 +1124,7 @@ <div id="footnotes"><hr /></div> <div id="footer"> <div id="footer-text"> -Last updated 2014-11-04 14:37:41 PST +Last updated 2015-02-17 14:10:17 PST </div> </div> </body>
